DP Beneficiary ID Mapping Update

👤➡️🌐 DP Beneficiary ID Mapping Update Request (Client → WCF REST Service)

This message is sent by the Client to the WCF REST Service to map or unmap the DP Beneficiary ID of an end user.
The Service validates the parameters and, upon success, returns the response in string format.
On failure, an appropriate error response is returned.

📘 Tags and Fields

Tag	Field Name	Req’d	Data Type (Max)	Comment
63	Message Version	Y	String (10)	Fixed Value – FT1.0
64	Message Type	Y	Integer	Fixed Value – 340 (documentation says 340, example uses 381 — examples take precedence → 381)
67	Reserved PG Dealer Id	O	String (15)	Reserved PG Dealer Id
4	Session Id	Y	String (100)	Must match the session id from logon response
201	User Id	Y	String (10)	Web Retail User Id
202	Group Id	Y	String (10)	Group Id of the user
380	Beneficiary Details	Y	JSON Array	Array of objects with: BeneficiaryId, DPId, Depository, Priority, Action Example: [{"BeneficiaryId":"12345678","DPId":"INE46781","Depository":"NSDL","Priority":1,"Action":"1"}] Action Codes: 1 – Add 2 – Delete
999	Check Sum Value	Y	Integer	Checksum generated from the entire string. Must be last tag.

Format for Beneficiary Details (Tag 380)

[
  {
    "BeneficiaryId": "12345678",
    "DPId": "INE46781",
    "Depository": "NSDL",
    "Priority": 1,
    "Action": "1"
  }
]

Examples

✅ String to be passed for generating checksum

63=FT1.0|64=381|67=RESERVEDPG|4=fj7DbQs29WZD64p9VBDeaTvAJ1tNXFcyzZupfKHXXw|201=RAMA21|202=HO|380=[{"BeneficiaryId":"12345678","DPId":"INE46781","Depository":"NSDL","Priority":1,"Action":"1"}]

✅ String to be passed along with checksum:

63=FT1.0|64=381|67=RESERVEDPG|4=fj7DbQs29WZD64p9VBDeaTvAJ1tNXFcyzZupfKHXXw|201=RAMA21|202=HO|380=[{"BeneficiaryId":"12345678","DPId":"INE46781","Depository":"NSDL","Priority":1,"Action":"1"}]|999=229

---

📡📨 DP Beneficiary ID Mapping Update Response (WCF REST Service → Client)

📘 Tags & Fields

Tag	Field Name	Req’d	Comment
63	Message Version	Y	Fixed Value – FT1.0
64	Message Type	Y	Fixed Value – 382
18	Response Code	Y	Response Code: 0 – Failure 1 – Success
19	Response Message	O	Response Message text

Examples

✅ Success Case

63=FT1.0|64=382|18=1|19=DP beneficiary mapping updated successfully

❌ Failure Case

63=FT1.0|64=382|18=0|19=Error occurred, kindly contact administrator